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ATARI 400/800 Keyboard 



OBBHO 



BREAK Halts current operation; returns computer from Programmed to 

Immediate mode; in Immediate mode, cancels current line 
CAPS/LOWR Shifts to lowercase or control-character mode 

ESC Press and release before next key; see Escape Sequences, p. 15 

SYSTEM RESET Halts current operation and initializes system; shifts computer 
to Immediate mode; dangerous when the disk drive is active 
A Toggles normal/ inverse video mode 

t'l RL. ESC. caps LOWR. SHIFT, A ATASCII characters; see ATASC11 Codes. 

Characters. & Keystrokes, p. 51. 



SHIFT Key Functions 


Keystroke 


Character or Action 


SHIFT-TAB 


Set tab stop 


SHIFT- < 


Clear display screen 


SHIFT- > 


insert blank line 


SHIFT-BACK S 


Delete current line 


SHIFT-CAPS LOWR 


Switch keyboard to upper-case mode 



( 


lKi. Key Combinations 


Keystroke 


Character or Action 


CTRL-TAB 


Clear tab stop 


CTRL-- 


Move cursor up one line 


CTRL- = 


Move cursor down one line 


CTRL- + 


Move cursor left one space 


CTRL-* 


Move cursor right one space 


CTRL-1 


Freeze restart screen display 


CTRL-3 


Usually results in an error 


CTRL-< 


Clear display screen 


CI Rl -> 


Insert a space 


(1 RI HACK S 


Delete next character 


CI Rl -CAPS LOWR 


Switch keyboard to graphics mode 



Cassette Use 

To write-protect Side A. hold up cassette with label toward you; remove tab from 
notch on top left. 

EOF Stops Tape 

To SAVE and LOAD program: 

■ Position tape; if start position not known, load programs until you reach it. 
• Type appropriate saving, loading command (see p. 11-12) 



• Wait for console beep — once for SAVE, twice for LOAD 

• Press PLAY (and RECORD for SAVE) on recorder; press RETURN on console 

■ Wait for 20-second data file leader tone from TV (SAVE only) 

■ Wait for soundburst(s) from TV speaker to signal SAVE/LOAD in progress 

Diskette Use 

Diskettes can contain 64 files, 90K characters. File names begin with capital letter 
and contain 1-8 capital letters or numbers plus optional extension. File name 
extensions contain any combinations of 1-3 capital letters or numbers. 

Examples: 

DISKFILE.BAS B1234567.01A JUNK 

*.TXT Names all files with TXT extension 

FILE.* Names all files named FILE, any extension 

FILE* Names any file whose name begins with FILE 

FILE.*T Names any file whose extension ends with T 

DOS 

There are two versions of DOS, 1.0 and its replacement 2. OS. DOS 2. OS can 
always read diskettes prepared by DOS 1.0; the reverse is not always true. 

DOS Start-up Menu 

The DOS command activates the utilities menu, which includes choices: 
a. DISK DIRECTORY 

Lists files and free sectors 
Examples: 
RETURN 

Lists all files on drive #1 (default) 
D2: 

Lists all files on drive #2 disk; D optional 



7:,P: 

Sends list of all files on drive #/ to printer 
2*. TXT 

Lists all .TXT files on drive #2 
*D1SKFILE BAS038 

Signifies a locked (*) file with 38 128-byte blocks (possible display) 

b. RUN CARTRIDGE 

Transfers control from operating system to ROM cartridge; substitute 
SYSTEM RESET with DOS 2.0S if MEM. SAVE file active 

c. COPY FILE 

Copies files on same diskette with one drive, on different diskettes with two 

drives (use menu item o to copy on different diskette on same drive) 
Examples: 

FILE1.BAS.FILE1.BAK 

Copies FILE1.BAS on diskette on drive #l to FILE1.BAK on same diskette. 

Will overwrite F1LE1.BAK if it already exists 
NAMES.TXT, NUMBERS.TXT/ A 

Appends NAMES.TXT to end of NUMBERS.TXT(2.0S only); overwrites 

NUMBERS.TXT if /A not given 
PROG1.BAS.PROG2.BAS/ A 

Appends correctly onlv if BASIC program was stored with LIST not with 

SAVE 
*.BAS,D2: 

Copies all BASIC files on drive #1 to drive #2 

d. DELETE FILE(S) 
Examples: 

D2:FILE 

Deletes FILE on drive #2. (Wild cards okay) 
D2:FILE/N 

Deletes FILE on drive #2. (/N disables confirmation dialog) 



e. RENAME FILE 

Renames a file; requires no drive number with new name; old name can 

be ambiguous (don't rename DOS. SYS or DUP.SYS files) 
1:*.DAT*.TXT 

Renames all .DAT files on drive #/ to .TXT files (drive number optional 

with old name, invalid with new); Danger: don't create duplicate filenames 
/. LOCK FILE 

Prevents changes to file. (Wild cards okay); lock DOS. SYS and DUP.SYS 

for protection 
g. UNLOCK FILE 

Permits changes to file. (Wild cards okay) 
h. WRITE DOS FILES 

Copies DOS. SYS and DUP.SYS files from memory to disk (don't use menu 

item C) 
/. FORMAT DISK 

Prepares new disk; erases all information on disk 
/, DUPLICATE DISK 

Copies entire disk; erases program in memory if used with DOS I.O (enter 
1,1 

if using one drive; enter 1 .2 or 2, 1 with two drives) 
k. BINARY SAVE 

Saves a memory area onto disk as an object file 
Examples: 

PROGM1 .OBJ/A.3B00.4AFF 

Saves memory area, beginning at hex address JEOO and ending at hex 

address 41 AFF 
If DOS 1.0: POKE program starting address into memory locations 736 and 737 
before selecting K.; /A saves address. If DOS 2. OS: INIT.RUN option is displayed, 
RUN is program starting address, INIT starting address of initialization routine; 
INIT.RUN in hex. 
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PROGRM4.0BJ,3EW,517F..4800 

Omits INIT 
AUTORUN.SYSISTARTJ/END] 
Saves program to file containing built-in initialization routine (program must 
end with RTS instruction); executes automatically when DOS 2. OS booted 

/. BINARY LOAD 

Loads a binary file created by DOS option K. or one created by the Assem- 
bler/Editor cartridge; PROGM I. OBJ N N to block execution 

m. RUN AT ADDRESS 

In hex; with RTS instruction, control returns 

n. CREATE MEM.SAV 

Saves and stores contents of memory area used by DOS menu program (exit 
menu to restore MEM.SAV contents to memory) (DOS 2.0 only) 

o. DUPLICATE FILE 

Copies files between diskettes using one drive. (Wild cards okay) (DOS I.O 
erases program in memory) 

Program Development 

Line numbers range from to 32767. Logical line contains II4 characters. Colons 

separate multiple statements: 

LIST Displays first line through last line (BRI \k halts listing) 

list too Displays line 100 

LIST 100,860 Displays program lines 100-H60 stored in memory 

NEW Clears memory for new program (deletes old program and 

variables) 
RUN Executes program (sysi I M Rl si I and BREAK hall program 

execution, return computer to Immediate mode) 
STOP Halts program execution, returns computer to Immediate 

mode 
END Halts like STOP but voices off, I O channels I-7 closed; not 

needed at end of program 



CONT Restarts program on next line after mid-line BREAK, stop, 

END; restarts but doesn't execute statement that caused error 

PRINT FRE(O) Displays number of bytes available in RAM for program; 

can be any number 

Program Files 



Command 


Loads 


Saved By 


Format 


Effect 


Comments 


CLOAD 


All 


CSAVE 


Tokens 


NEW 


Cassette only; 
faster than LOAD 


ENTER 


All pari 


LIST 


ATASC1I 


Merges 

program 

lines 


Invoke NEW before ENTER 
to erase program and variables 
already in memory 


LOAD/RUN 


All 


SAVE 


Tokens 


NEW 





To Transfer Program to Cassette: 

CSAVE Saves program and its Variable Name Table (VNT) in token 

format (read with CLOAD) 
SAVE "C:" Saves programs like CSAVE; read with LOAD or RUN 

LIST "C:", 90,900 Saves lines 90 to 900 in ATASCII code (read with ENTER) 
BREAK Halts transfer to cassette 

To Transfer Program from Cassette to Memory: 

CLOAD Loads program saved with CSAVE or SAVE "C:"; invokes NEW 

LOAD "C:" Loads program and VNT saved with SAVE; invokes NEW 

RUN "C:" Loads program and VNT saved with SAVE; invokes NEW and 

executes after loading 
300 RUN "C:" Runs next program on tape (chaining); pressing return at beep 

deletes from memory VNT and program containing line 300 
ENTER "C:" Loads lines saved with LIST; adds lines to program and VNT 

in memory (halt with BREAK) 
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To Transfer Program to Disk: 

SAVE "DPR0G1" Saves PROG1 and its VNT to drive #1 in token 

format (read with LOAD or RUN) 
LIST 'DPROGILST", 90,900 Saves lines 90 to 900 in ATASCII code (read with 

ENTER) 
BREAK Halts transfer to diskette 

To Transfer Program from Disk to Memory: 

LOAD 'DPROGV Loads PROGl and VNT saved with SAVE; invokes NEW 

RUN "D PROG1" Loads programs like LOAD, but executes after loading 

300 RUN DPROG2" Loads runs PROG2 (chaining); deletes VNT and program 

containing line 300 from memory 
ENTER "DPROG.LST" Loads program lines saved with LIST; merges lines with 

programs and VNT in memory; (halt with break; 

memory not erased) 

To Save and Load Subroutines and Subroutine Libraries: 

LIST "C:" Saves subroutine 

ENTER "C:" Merges saved subroutine with program in memory 

LIST "DSUBR1" Stores subroutine SUBR1 in library 

ENTER "DSUBR7" Merges SUBRl with program in memory 

ATARI BASIC Language 

Initializing Statements 

Variable Name Table (VNT): 

Room for 128 variable array names. NLWclears VNT (CLR doesn't). Invoked 

by CLOAD, LOAD, RUN. ENTER adds variables to existing VNT; CSAVE and 

SAVE save VNT; LIST doesn't (to clear VNT but not program: LIST program to 

cassette or diskette, invoke NEW, then ENTER program). 
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Variable Names: 

First character must be a capital letter; capitals or digits for rest of name. Up to 
114 characters; string variables end with $. Dimension numeric array variables and 
string variables before use: 
CLR Undimensions variables; resets pointer to start of DATA list 

(use before redimensioning) 
DIM A$(24) Assigns 25-character string (0 to 24) to AS 

DIM X(70) Assigns up to 1 1 array elements indexed 0< 10, to X; COM is 

the same as DIM 
DIM Y(3.2) Y is two-dimensional array indexed 0-3. 0-2; dimensions 12 

array elements (3 groups of 4) 

DATA and READ can assign values to multiple variables: 

DATA "May '84", 2+2, 7 Contains three values: "May '84", 2+2, and 7. 

READ DATES, SUMS, NUM Reads DATA above: causes error if DATA statement 
does not contain at least three elements 

DATA 1.4E-2,,2/3, Contains 4 values (2nd and 4th values are null string con- 
stants); scientific notation okay for numeric variables 

DATA "May, 1984" Contains the two values "May and 1984" 

DAJA5,W:READX,Y Contains three values: 5. 10: READ X. and ^statement follow- 
ing DATA on same line treated as data) 

READ A: READ B If READ A reads item 4 in a DATA statement list. READ B 
reads item 5 

RESTORE Resets pointer to first value listed in first DATA statement in 

program 

RESTORE 140 Resets pointer to DATA statement on line 140 
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Numbers 
Numeric Constants: 

Floating (decimal) point numbers (no commas); can have nine significant digits 
plus two-digit exponent: range from -9.99999999E+97 to 9.99999999E+97 

(numbers nearer than H 9.99999999E— 98 are set to 0). Use scientific notation 

if 10 digits before decimal, if nearer than +0.01: (2E+ 02= 2000 .001 = IE- 03 
-12345E+08=~ 123450000- 1.23E — 08 = — 0. 0000000123). 

Math Functions and Statements 

Y=ABS(X) Absolute value of X 

Y=ATN(X) Arctangent of X; -PI 2 to PI/2 

Y=CLOG(X) Common logarithm (base 10) of X 

Y=COS(X) Cosine of X radians; X degrees with DEG 

Y=EXP(X) e (2.71828179) to the X power 

Y=INT(X) Largest integer <= X 

Y=LOG(X) Natural logarithm (base e) of X 

Y = RND(X) Random number (0 to 1 ) 
Y=SGN(X) Sign of X 

Y = SIN(X) Sine of X radians: X degrees with DEG 

Y = SQR(X) Square root of X 

DEG Arguments of trigonometric functions interpreted in degrees 

RAD Arguments interpreted as radians (default condition) 



Expressions 
Valid 


Invalid 


A+B, A=B. A AND B 

CHRSUOKAS 

SI l<5(2 3<>AS 


AS=B. A$+B$, AS AND B$ 
CHK$(I())<CHRS(I4) 
STRS(2 3)<>STRS(3 4) 



13 







Numeric 


Operators 






Precedence 


Operator 


Meaning 




High 9 


( ) 


Parentheses denote order 


of evaluation 




8 


A 


Exponentiation 






7 


- 


Unary Minus 




Arithmetic 


6 


* 


Multiplication 




Operators 


6 




Division 






5 


+ 


Addition 






5 


- 


Subtraction 






4 


= 


Equal 






4 


< > 


Not equal 




Relational 


4 


< 


Less than 




Operators 


4 


> 


Greater than 






4 


< = 


Less than or Equal 






4 


> = 


Greater than or Equal 




Boolean 
Operators 


3 

2 

Low 1 


NOT 
AND 
OR 


Logical complement 
Logical AND 
Logical OR 



Boolean Truth Table 


The AND 


operation results 


n a 1 only if both va 


ues are 1. 






1 AND 1 = 1 


1 AND0=0 








AND 1 =0 


AND0=0 




The 


OR o 


Deration results in 
1 OR 1 = 1 
OR 1 = 1 


a 1 if either value is 
1 OR0 = 1 
OR = 


. 


The 


NOT 


operation logical! 


' complements each value. 






NOT 1 =0 


NOT = 1 
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Strings 



Strings can be up to 114 characters, can use any ATASCII characters, are enclosed 

by quotation marks (e.g., "SUBTOTAL" "ACCOUNT 4019-181"): 

CHRS(34) Assigns quotation mark; e.g., PRINT "CHR$(34); "SPEED 

KILLS" 
ESC CTRL— Assigns "cursor left" to a string and echoes — (subsequent 

PRINT statement moves cursor left) 
ESC ESC Prints echoed character when entered before escape-sequence 

character 
PRINT CHR$(30) Displays — 



Escape Sequences 


Keystroke 


Echoed 
Character 


ATASCII 
Code 


String Character 


ESCXESC 


Si 


27 


Escape code 




ESCXBACK S 


a 


126 


Cursor left, replace with blank 


space 


ESCXTAB 


E 


127 


Cursor right to next tab stop 




ESCXCTRL- 


5 


28 


Cursor up 




ESCXCTRL- = 


[g 


29 


Cursor down 




ESCXCTRL-* 


s 


30 


Cursor right 




ESCXCTRL- + 


a 


31 


Cursor left 




ESCXCTRL-BACK S 


□ 


254 


Delete character 




ESCXCTRL- > 


□ 


255 


Insert character 




ESCXCTRL- < 


m 


125 


Clear screen 




ESCXCTRL-TAB 


a 


158 


Clear tab stop 




ESCXCTRL-2 


□ 


253 


Sound built-in speaker 




ESCXSH1FT-BACK S 


□ 


156 


Delete line 




ESC\SHIFT-> 


□ 


157 


Insert line 




ESC\SHlFT-< 


g] 


125 


Clear screen 




ESCXSHIFT-TAB 


□ 


159 


Set tab stop 
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Substrings and Concatenation: 

AS is the five-character string ABCDE: 

AS(2,4) Specifies substring BCD; 2nd through 4th characters 

A$(2) Specifies same substring as AS(2,5); 2nd through last character 

A$(2>1,X) Specifies substring ABC if X=3 (expressions and variables okay) 

To concatenate AS and BS. use LEN to make BS a substring of AS (e.g., following 

program); concatenated string can be any length: 

10 DIM A$(15), B${9), C$(5) 

20 A$ = "ATARI ": B$="DISK": C$="GUIDE" 

30 B$ (LEN(B$)+1)=C$ 

40 AS (LEN(A$)+1)=B$ 

50 PRINT A$ 

The preceding program prints ATARI DISKGUIDE. 

String Functions: 

Conversion to and from strings: 

ASC("/lflC") Returns 65. ATASC1I code of first character in string 

CHR$(65) Returns "A", string value of ATASCI1 code 

STR$(74) Returns "14". string equivalent of numeric value 

STRS(2/3) Returns "0.6666666666" 

VAL("74") Returns numeric value 14. equivalent of numeric string; VAL's 

argument must be in acceptable numeric format 
ADH(string) Returns address of first character in string 
A=USR(ADR(St/fi/?S)) USR executes machine code in SUBRS 
LEN("/4 BC") Returns 4. the number of characters in the string 

BASIC Programming Statements 
Branch Statements: 

GOTO 700 Branches to line 100 

GOTO 3*A Calculates line number from expression 
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ON/1 + 7 G0JO50.80, 1 10 Computes A + l; must be numeric expression between 
and 255 



A 


A+l 


Go To Line 


() 
1 
2 


1 

7 

3 


50 
80 
1 10 



Create loops with FOR NEXT; terminate innermost loop first: avoid branching 

out of loop (wastes memory). 

FOR N=0TO 99 STEP 2 N will have values of 0,2,4, ... 98 (default=STEP 1) 

FOR N=99 TO STEP-1 N will have values of 99. 97.. .0 

FOR N=A*3 TO 70 STEP A>4 Uses expressions for index values and step sizes 

NEXT Paired with FOR statement (FOR invalid without it) 

70 GOSUB A*W00 Calls subroutine at line 2000 if A=7 (following 

program); 70 ON A GOSUB 1000,2000 can replace 
line 70 in program; A can be 0-255; calls subrou- 
tine at line 2000 if A=2 
RETURN Branches from subroutine to line 80 (line following subroutine call) 
POP Erases last RETURN address; used when exiting subroutine with GOTO 

instead of RETURN; prevents accumulation of unused addresses 
70 GOSUB AM000 



80 PRINT "RETURNED" 



2000 REM Subroutine 



2050 RETURN 
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Nesting: 

A subroutine can call another subroutine. Recursion is invalid: 

TRAP 20000 Branches to error handling subroutine at 20000; see p. 42 

PRINT US R( 7536) Branches to machine-language program at memory location 
1536; see p. 42 

IF A=B+5 THEN PRINT MSG$ If the expression A=B+5 is true, MSGS is 

printed; executes next line if false 

IF Q<14 THEN lfll=0: GOSUB 2000 If expression Q<14 is true, IN=0 sets IN to 

and branches to subroutine on line 2000 

IF MM$=DD$ THEN 100 If expression MMS=DD$ is true, begin 

execution at line 100; GOTO implied 

IF A$="X" THEN IF B=2 THEN 50 If both expressions are true, begin execu- 
tion at line SO; equivalent Boolean 
expression can be used instead: IF 
A$="X" AND B=2 THEN 50 

General Programming Statements 

BYE Switches from BASIC to Memo Pad mode; SYSTEM reset restores 

program and VNT 
CONT Resumes program on next line if halt in middle of line 
DATA Creates list of values (READ assigns them to variables); see p. 12 
END i Halts program 
X=0 Sets value of X (LET optional) 
LET EXP = 2 Allows BASIC keyword as variable name 

NEW Deletes current program and variables 

READ Assigns values from DATA statements to variables; see p. 12 

REM Treats text to right of REM as remarks; not executed 

RESTORE 140 Restores data pointer to 1st item on line 140 

RESTORE Restores data pointer to 1st DATA statement in program 

STOP Stops program execution; prints line number 

SYSTEM RESET Key initializes system (data may be lost) 
TRAP 20000 Branches to error handling subroutine at line 20000 if any 

error is encountered after statement 
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To Halt Program Execution 


BREAK 


END 


STOP 


SYSTEM 

RESET 


Immediate mode restored 

Resume execution with CONT 

1 channels 1-7 cleared, sound turned off 


X 
X 


X 
X 
X 


X 
X 


X 
X 



Keyboard Input 

Input data can be numeric or string values; must end with RETURN; Screen 

echoes entry: 

INPUT A.B Accepts two numeric values separated by comma on one line 

or on two lines (return after each) 

INPUT AS.BS Accepts two string values on two lines only 

80 PRINT "HOW MUCH IS ";N*9; (semicolon at end of line suppresses carriage 

return) 

90 INPUT ANS Waits for response with cursor on same line as prompt 

message 

G€\U1,A Assigns 5 to A if 5 entered; specifies input from channel 1 

(channel must be opened with OPEN first); entry doesn't 
echo or require RETURN; entry can be one ATASCII 
character only (see following program) 

10 OPEN #1,4,0, "K:" 

20 PRINT "Are you there?" 

30 PRINT "Press RETURN if so." 

40GET#1,R 

50 IF R0155THEN 40 

60 PRINT "OK, let's get on with it." 
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Graphics 



Graphics Modes Summary 


it 

■- >i 


M 

E 

D.-Q 


■Q 

o >■ 

O < 


$ 
a 

55 X 

56 g 

= E 

£ a 


■a .2 
1 » 

8 * 

a> 
O O 

u. o 


M ,_ 

i! 2 

« o 


'fit 

V 

u. K 

"2 ° 
O O 
fiQ U 


c 
a 

is 

6 (j 

5* 


■a 

V 

O ^T 

E 2 
5S 


Normal text 





1 color, 

2 luminances 


40X24 


1 (Color is not 
selectable) 


2 


4 


* 


992 


Double-width 
text 


] 


5 


20X20(splii) 
20X24 (full) 


0. 1, 2. 3 


4 


4 




674 (split) 

672 (full) 


Double-width, 
double-height 
text 


2 


5 


10X20 (split) 

l2X20(full) 


0. 1. 2. 3 


4 


4 




424 (split) 
420 (full) 


Four-color 
graphics 


3 

5 
7 


4 
4 
4 


40X20(splil) 
40X24(full) 

80X40(splil) 
80X48(full) 

l60X80(split) 
l60X96(full) 


0, 1. 2 
0, 1, 2 

0. 1. 2 


4 
4 
4 


4 
4 

4 


COLOR 1: 

register 
COLOR 2: 

register 1 
COLOR 3t 

register 2 
COLOR 0, 

register 4 


Mode 3: 
4.14(split) 
432 (full) 
Mode 5: 
II 74 (split) 
Il76(full) 
Mode 7: 
4190(splil) 
4200 (full) 


I wo-color 
graphics 


4 

6 


2 
2 


80X40 (split) 
80X48 (lull) 

l60X8()(splil) 
l60X96(lull) 



(1 


4 
4 


4 
4 


COLOR 1: 
register 

COLOR 0: 
register 4 


Mode 4: 

694(split) 

696(full) 

Mode 6: 

2l74(split) 

2l84llull) 


High- 
resolution 
graphics 


s 


1 color. 

2 luminances 


320XI60(split) 

32()XI92(full) 


1 (color is not 
selectable) 


2 


4 


COLOR 1: 

register 1 

COLOR 0: 

register 2 


« 1 ! 2 (split) 

81 38 (full) 


* In ModcO, C 
followed by 


OLOR 

'LOT 


will accept an 
>r DRAWTOs 


A 1 ASCII charade 
tatements. will plat 


r to plot with, Fc 
e ! characters on 


r exam 
the sere 


pie. COLOR ASCCT 

en. 


) in ModcO. 
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Color Register Assignments. Graphics Modes 1 and 2 


Number 


Color 


Number 


Color 





G rev 


8 


Light Blue 


1 


Gold 


9 


Blue-Green 


2 


Orange 


10 


Aqua 


3 


Red 


1 1 


Green-Blue 


4 


Pink 


12 


Green 


5 


Violet 


13 


Yellow-Green 


6 


Blue-Purple 


14 


Orange-Green 


7 


Blue 


15 


Orange 



Color Numbers Ijsed with SETCOI.OR 


Register 

Number 


Color 
Number 


Luminance 
Value 


Actual 
Screen Color 



1 

2 
3 
4 


2 
1 2 
9 
4 



8 
10 
4 
6 



Orange 
Aqua 
Blue 

Light Red 
Black 



Default (Preassigncd) Color Register Setting 


Characters 


ATASCII 

Values 


Color Register 
Assigned 


Upper-case alphabet 
(A-Z), numbers, special 
characters (! $ + -) 


32-90 
160-218 


Normal: 
Inverse*: 2 


Lower-case* alphabet 


61-122 
225-250 


Normal: 1 
Inverse*: 3 


*Lo\ver-case and inverse characters display as n 
text. They are assigned to different registers, ho 


3rmal, upper-case 
wever. 
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GRAPHICS 

GRAPHICS n 

GRAPHICS n+16 
GRAPHICS n+32 
GRAPHICS /1+48 
CLOSE #6 

Character Display: 

LOCATE 3, 12,X 

POSITION 10,3 
PRINT "text" 



INPUT "text" 

Graphics Modes 1 and 2 

PRINT #6, "text' 



Selects normal text mode: opens channel #6 for output to 

screen 
Selects graphics mode n (n= 1-8) with four-line text window; 

clears screen 
Provides full-screen graphics, suppresses window 
Suppresses screen clearing 
Suppresses window and screen clearing 
Closes channel #6 after GRAPHICS n opens it 

Assigns X the ATASCI I code of character X at column 3, row 
12 (modes 0-2); assigns X the color register (modes 3-8) 

Begins subsequent PRINT statement at column 10, row 3; also 
subsequent GET, PUT. INPUT LOCATE 

Uses window in modes 1-8, displaying "text" in graphics 
mode 

Uses window 



Displays double-width characters in graphics window; bits 7 
and 8 determine character color; bits 1 through 6 define 
character 



5 REM GRAPHICS MODE 1 DEMO 



10 GRAPHICS 1 
20 POKE 756,226 
30 PRINT #6 
40 PRINT #6 
50 PRINT "ART: 
60 COLOR 
70 PLOT 1,2 
80DRAWTO 18,2 



.'Selects graphics mode 1, standard character set 
;Selects alternate character set 

; "you've got to have" 

.GRAPHICS DEMO" 

;Produces " " in color register 1; see Color, page 23 

;Displays " " at column 1 row 2 

;Uses s to draw line from 1,2 to 18,2 
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COLOR and Graphics Modes 1 and 2 












(Charact 


ers and color registers selected by values of COLOR 


numexpr) 








Va 

Color 


ue for 
Register 




Character* 


Value for 
Color Register 


Character* 





1 


2 


3 


Std. Alt. 


I 2 


3 


Std. 


Alt. 


32** 





160 


128 


i*j 


51 19 179 


147 


a 


a 


.11 


1 


161 


129 


B a 


52 20 180 


148 


a 


a 


.14 


2 


162 


130 


E CI 


53 21 181 


149 


i ..vj 


H 


35 


3 


163 


131 


Li H 


54 22 182 


150 


6, 


a 


36 


4 


164 


132 


I 3J 


55 23 18.1 


151 


B 


a 


.17 


5 


165 


133 


B E 


56 24 184 


152 


a 


a 


.IK 


6 


166 


134 


A 


57 25 1 85 


153 


a 


E 


.19 


7 


167 


135 


E S 


58 26 186 


154 


E 


a 


40 


8 


168 


136 


a a 


59 27 187 


None 


E 


E 


41 


9 


169 


137 


a a 


60 28 1 88 


156 


E 


a 


42 


10 


170 


1.18 


H E 


61 29 189 


157 


g 


a 


41 


II 


171 


139 


a a 


62 30 190 


158 


E 


a 


44 


12 


172 


140 


E El 


63 31 191 


159 


a 


a 


45 


13 


173 


141 


B 3 


64 96 192 


224 


a 


a 


46 


14 


174 


142 


B Q 


65 97 193 


225 


a 


a 


47 


15 


175 


143 


B bJ 


66 98 194 


226 


a 


a 


48 


16 


176 


144 


b a 


67 99 195 


227 


a 


a 


49 


17 


177 


145 


a a 


68 100 196 


228 


a 


a 


50 


18 


178 


146 


a a 


69 101 197 


229 


a 


a 


Note: 














* For 


standard characters, POKE 756.224. For alternate characters. POKE 756.226. 






** 155 


selects 


the same 


character and color register as value 32. 








* No 


value selects this 


color register character combination. 
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COLOR and Graphics Modes 1 and 2 










(Charact 


ers and color registers selected by values of COLOR numexpr) 






Value for 
Color Register 


Character* 


Value for 
Color Register 


Character* 





1 2 


3 


Std. Alt. 


1 2 


3 


Std. 


Alt. 


7(1 


102 198 


2.10 


LB LS 


8.1 115 211 


243 


LI 


H 


71 


10.1 199 


2.H 


m 


84 116 212 


244 


m 





72 


104 200 


2.12 


LH1 


85 117 21.1 


245 








7.1 


105 201 


2.1.1 


m a 


86 118 214 


246 


m 





74 


106 202 


2.14 





87 119 215 


247 


m 


s 


75 


107 201 


2.15 


m le 


88 120 216 


248 


m 





76 


108 204 


2.16 


E S 


89 121 217 


249 


m 





77 


109 205 


2.17 


m 


90 122 218 


250 


m 





78 


1 10 206 


2.18 


m 


91 123 219 


251 


i 


a 


79 


1 1 1 207 


2.19 


m 


92 124 220 


252 


: ; 


DD 


SO 


1 1 2 208 


240 





9.1 None* 221 


253 


CD 


5\ 


SI 


1 1 .1 209 


241 


m 


94 126 222 


254 





a 


82 


114 210 


242 


m m 


95 1 27 22.1 


255 





LE 


Note: 












* Foi 


standard characters. POKE 756,224. For alternate characters. POKE 756.226. 






•• 155 


selects the same 


character and color register as value 32. 








* No 


value selects this 


color register character combination. 
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Display of Points, Lines, and Solid Areas in Modes 3-8: 

PLOT 5,15 Displays dot of color at column 5, row 15; gets register from last 

COLOR statement 
DRAWTO 5.75 Draws a line from the point displayed by the last PLOT or 

DRAWTO statement to column 5, row 15; staircases on diagonal 
LOCATE 5.1 5, X Assigns to X the color register number of the point at column 

5, row 15 
POSITION 5.15 Moves cursor to column 5, row 15 at next GET, PRINT PUT 

INPUT, LOCATE 
XIO 18,tt6,0,0,"S." Fills the screen or shape with solid color 
5 REM DRAWS SHAPE AND FILLS IT 

10 GRAPHICS 21 .Graphics mode 5, no window 

20 COLOR 3:POKE 765,2 ;Border color 3, fill color 2 
30 PLOT 70,40 .Start shape 

40 DRAWTO 50,10 
50 DRAWTO 30,5 

60 POSITION 10,40 ;Finish shape 

70 XIO 18,#6,0,0,"S:" ; Fills shape with horizontal lines from upper left 

Color: 

SETCOLOR Changes color-register default hue and luminance values 

COLOR Specifies color register in graphics modes 3-8, register and 

character in graphics modes 0-2 
SETCOLOR 0,4, 14 Sets hue of color registers to 4 (pink); sets luminance to 14 

(14 is brightest: is darkest; only even-numbered settings 

are meaningful) 
COLOR 2 Determines that next PLOT or DRAWTO will use; 

■ Color register 1 in graphics modes 3, 5, or 7 

■ CHR$(2) in graphics mode 

• CHR$(2) (standard character) 

• CHRS(34) (alternate character using color register 

I in graphics modes 1 and 2 
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Player-Missile Graphics Table Layout 



Missile 
Area 



8 bits 



Unused 



PlaverO 



Plaver 



Player 2 



Player 3 



Offset from PMBASE 



(Double 
Resolution) 



+384 
+ 512 

+640 
+ 768 
+896 
+ 1024 



(Single 
Resolution) 



+ 768 
+ 1024 

+ 1280 
+ 1536 
+ 1792 
+ 2048 



Note: All locations shown are offsets from the start of the player-missile graphics table 
base address (PMBASE). 



Player-Missile DMA Control Register Values 


Value to POKE 


Setting Which Results 


4 
8 

12 
Add 16 


Enable Missile DMA only 
Enable Player DMA only 
Enable Player-Missile DMA 
Single-line resolution 

(double-line resolution = default) 
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Plavfield and Player-Missile Color Register 


Values 


Color Value 


Color Value 


Color 


Decimal 


Hex 


COlor 


Decimal 


Hex 


Grey 








Blue 


128 


80 


Gold 


16 


III 


Light Blue 


144 


90 


Orange 


32 


20 


Turquoise 


160 


A0 


Red 


48 


30 


Green-Blue 


176 


B0 


Pink 


64 


40 


Green 


192 


CO 


Violet 


80 


50 


Yellow-Green 


208 


DO 


Blue-Purple 


96 


60 


Orange-Green 


224 


E0 


Blue 


112 


70 


Light Orange 


240 


F0 


Add an even number. 2 to 14. to set luminance; 0= 


: no luminance. 1^ 


— maximum luminescence. 



Sound Generation 

SOUND Statement Controls TV Speaker: 
SOUND voice, pilch, distortion, volume 

voice 0-3 (four voices) 

pitch (highest note) to 255 (lowest note) 

distortion 0-15; 10 and 14 produce pure tones; other even numbers 
add noise to pure tones; odd numbers turn off sound 

volume (no sound) to 15 (full volume) 

All four voices turned off by pressing SYSTEM RESET or entering: 
CLOAD, CSAVE, DOS, END, ENTER, LIST (except to display screen), 
LOAD, NEW, RUN, SAVE. 
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Joysticks 

STICK(3) 
STRIG(3) 



Device I/O 



Returns integer identifying position of stick #5 
Returns if #J stick trigger being pressed, 1 if released 



STICK Function Values 




PADDLE(3) Returns 1-228 identifying position of paddle #J; full clockwise 

is 1. full counterclockwise is 228 
PTRIG(3) Returns if paddle #j trigger is pressed; 1 if released 
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Printer Port 

The ATARI 820/822 Printer attaches directly to the serial bus, and the ATARI 825 
Printer is connected to the parallel port of ATARI 850 Interface Module. ATARI 
820/822 has automatic EOL at character 40 (at 39 on screen but printer determines 
wraparound point); ATARI 825 has automatic EOL at character 80. ATARI 825 
uses some ATASCII codes as control characters: 

Sends lines 10-100 to printer 
Sends EOL character to printer (default) 
Prints "hits'" at column stop 1, "runs" at II, outputs next 
PRINT statement at 21 (delete comma or semicolon 
at end of line with ATARI 825) 
Prints like LPRINT statement; requires OPEN #6,8,0,"P:" 
Prints 7 (single numeric value, modulo 256); requires 
OPEN #6,8,0,"P:" 

Standard Printer Character Set Summary 



LIST "P: ",10,100 

LPRINT 

LPRINT "hits" "runs 



PRINT #6,'77/fs' 
PUT #6,7 



Decimal 
Code 


Character 


ATARI 820/822 Printer 


ATARI 825 Printer 


0-3 1 


Space 


Control characters 


32-95 


Same as displav screen 


Same as display screen 


96 






97-122 


Same as displav screen 


Same as display screen 


I23 


[ 


] 


1 24 


I 


I 


I25 


I 


I 


1 26 


~ 


~ 


I27 


Space 


Non-printing 



To print sideways characters on the 820 printer with PRINT# or PUT# state- 
ments, open the printer channel with: OPEN #4,8k83,"P:", then use PRINT #4 or 
PUT#4 to direct the output. The character set is slightly different. Decimal 48-95 
correspond to the normal character set, but decimal 96-127 repeat decimal 64-95. 
There are 29 characters per line. 
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Printer Control Characters (ATARI 82S Printer) 


Decimal 


Graphics 




ATARI 825 


Code(s) 


Character(s) 


Keystroke(s) 


Printer function 


10 




E 


CTRL-J 


Line feed 


27 & 10 


IB 


E 


ESCXESC & CTRL-J 


Reverse line feed 


27 & 28 


SB 


® 


ESCXESC & ESCXCTRL - - 


Half-line feed 


27 & 30 


E 


m 


ESCXESC & ESCXCTRL - + 


Reverse half-line feed 


13 




□ 


CTRL-M 


Carriage return with 
automatic line feed 


15 




□ 


CTRL-O 


Start underlining 


14 




y 


CTRL-N 


Stop underlining 


27 & 14 


OD 


y 


ESCSESC & CTRL-N 


Start double-wide printing 


27 & 15 


E 


a 


ESCXESC & CTR1.-0 


Stop double-wide printing 


27 & 19 


E 


B 


ESCXESC & CTRL-S 


Select standard (10 cpi) 
characters 


27&20 


E 


a 


ESCXESC & CTRL-T 


Select condensed (16.7) 
characters 


27 & 17 


m 


H 


ESCXESC & CTRL-Q 


Select proportionally sized 
characters 


27 & 1 


E 


11 


ESCXESC & CTRL-A 


One dot blank space 


27 & 2 


E 


a 


ESCXESC & CTRI.-B 


Two dot blank spaces 


27 & 3 


E 


s 


ESCXESC & CTRI.-C 


Three dot blank spaces 


27 & 4 


E 


ffi 


ESCXESC & CTR1.-D 


Four dot blank spaces 


27 & 5 


E 





ESCXESC & CTRL-E 


Five dot blank spaces 


27 & 6 


E 





ESCXESC & CTRL-F 


Six dot blank spaces 


8 & m* 




s 


CTRL-H & keystroke* 


Backspace nn* dots 


* Thccharactt 


r thai follows ih 


: backspace control character (ASCII code 8) is interpreted as the 


number of c 


ots 10 


:>ackspac 


e ' Use Appendix D to select the ( 


■eystroke which produces the 


ATASC1I c 


haracter whose i 


ode number equals nn. the numbe 


of dots to backspace. 
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General Device I/O 

OFEN fjchan, task, aux, dev 



Use before accessing an external device for input or 
output; see following tables for parameter values; 
be sure channel to be OPENed is already closed 
(use CLOSE statement) 



CLOSE #6 Closes Channel 6 



OPEN Parameter Number 2 (auxexpr) 


Device 


Function Description 


Value 


Program recorder 


Normal inter-record gaps 





(C:) 


Short inter-record gaps 


128 


Disk drive 


Ignored 





{D[n]:fi!ename 






lext]) 






Screen editor 


Ignored 





(E:) 






Keyboard 


Ignored 





(K:) 






Printer 


Normal characters 





(P:) 


Sideways characters (ATARI 820) 


83 


RS-232 serial port 


Ignored 





(RM0 






Screen display 


BASIC graphics mode 





(so 


BASIC graphics mode 1 


1 




BASIC graphics mode 2 


2 




BASIC graphics mode 3 


3 




BASIC graphics mode 4 


4 




BASIC graphics mode 5 


5 




BASIC graphics mode 6 


6 




BASIC graphics mode 7 


7 




BASIC graphics mode 8 


8 
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OPEN Parameter Number 1 {taskexpr) 


Device 


Task 


Task 






Number 


Description 






Program recorder 


4 


Read 






(C:) 


8 


Write 






Disk file 


4 


Read 






{D[i\]:fHenanw 


6 


Read disk directory 






[.«■/]) 


X 
9 
12 


Write - new file 

Write append 

Read and write update 






Screen editor 


8 


Screen output 






IE:) 


12 


Keyboard input & screen output 






13 


Screen input & output 






Keyboard 


4 


Rend 






(KO 










Printer 


8 


Write 






(!':) 










RS-232 serial port 


5 


Concurrent read 






(R[n]:J 


8 
9 
13 


Block write 
Concurrent write 
Concurrent read and write 






Clear 


Text 








Screen display 


8 


Screen 


Window 




Read 


Write 


Yes 


No 




No 


Yes 


(S:) 


12 


Yes 


No 




Yes 


Yes 




24 


Yes 


Yes 




No 


Yes 




28 


Yes 


Yes 




Yes 


Yes 




40 


No* 


No 




No 


Yes 




44 


No* 


No 




Yes 


Yes 




56 


No* 


Yes 




No 


Yes 




60 


No* 


Yes 




Yes 


Yes 


* Screen always clear 


d in graphics m 


ode 0. T No separate text window 


in graphic 


s mode 0. 
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Channel I/O {Chan) 

Screen editor (E:). command input from keyboard (K:), simple 

INPUT, PRINT statements. LIST and PRINT statements to screen 
display (S:) 

1-5 BASIC program 

6 ATARI BASIC screen graphics statements, 

7 Some printer operations, cassette save/load, programs that don't save/load or 

use LPR1NT, LIST statements except to S: 

PRINT M6;A$;A Outputs AS concatenated to A and EOL character to device #6 

PRINT #6 Outputs EOL character only (default) 

PUT H6,X Outputs X (0-255 or modulo 256) to device U6 

LIST "C:". 100,200 Outputs lines 100 to 200 to Cassette (C\) without OPEN state- 
ment 

INPUT tt6,A$ Accepts entry from device #<5 (entry must end with return 

[from keyboard] or EOL [CH R$( 155)]) 

GET U6.X Accepts entry to variable X from device linked to #<5; if S: or 

E:, value returned is code of character or color register at 
cursor 

ENTER "C:" Inputs from cassette (C:) without prior OPEN statement 

Serial Port (850 Interface) 

For serial port use, turn on the disk drive through the 850 Interface Module, then 
the console. The disk drive must boot the RS-232 serial device handler into 
memory (AUTORUN.SYS). Don't turn the module off during the session unless 
only the ATARI 825 printer is attached. 
XIO cmd, ttchan, numl , num2, dev Conditions serial port after RS-232 device 

handler is in memory; see following table for summary of first three 

parameters 



33 



Summary of X10 Commands 


Action 


cmd 


numl 


num2 


Output partial block 
Control DTR, RTS, XMT 
Baud rate, word size, stop 

bits, & ready monitoring 
Translation mode 
Concurrent mode 


32 
34 
36 

38 
41) 



sec X 10 34 table 
see XIO 36 table 

see X 10 38 table 







see XIO 36 table 

ATASC11 code 




XIO 34 (Serial) Parameter numexpr^ 


Add one number from each 

column to get value of 

numexpr l 


Selected values 
of numexpri 




DTR 


RTS 


XMT 


DTR 


RTS 


XMT 


Value 


No change 
Turn off 

(XMT to 0) 
Turn on 

(XMT to 1) 




128 

192 




32 

48 




2 

3 


Off 

Off 
Off 
Off 

On 
On 
On 
On 


Off 
Off 
On 
On 

Off 
Off 
On 
On 



1 


1 



1 



1 


162 
163 
178 
179 

226 
227 
242 
243 
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XIO 36 (Serial) Parameters numexpr x and 


numexpr 2 




numexpr 








(Add one value from each column) 








Stop Bits Value 


Word Size Value 


Baud Rale Value 


DSK 


CTS 


CRX 


Value 


1 


8 bits 


300 


No 


No 


No 





2 128 


7 bits 16 


45.5 1 


No 


No 


Yes 


1 




6 bits 32 


50 2 


No 


Yes 


No 


2 




5 bits 48 


56.875 3 


No 


Yes 


Yes 


3 






75 4 


Yes 


No 


No 


4 






110 5 


Yes 


No 


Yes 


5 






134.5 6 


Yes 


Yes 


No 


6 






150 7 


Yes 


Yes 


Yes 


7 






300 8 














600 9 














1200 10 














1800 11 














2400 1 2 














4800 1 3 














9600 1 4 














9600 1 5 











XIO 38 (Serial) Parameter numexpr^ 



Add one value from each column 



Line 

Feed 

Append Value 



Translation 

ATASCII - ASCII 

Mode Value 



Input 

Parity 

Mode Value 



Output 

Parity 

Mode Value 



No 
Yes* 




64 



Light 

Heavy 16 
None 32 



Ignore 

Odd + 4 

Event 8 

Ignoret 12 



No change 

Odd I 

Even 2 

Bit on 3 



* Line feed character appended after carriage return (ATASCII EOL). 
t Check parity as indicated, then clear parity bit. 
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Data Files 

Sequential Access to Data Files: 

Buffer holds 128 characters; channels #1-5 available. 

Cassette Data Files 
To Create the File on Tape: 

OPEN #1,8,0,"C:" Opens channel ttl for output 8 to file (always 0) on cassette 
"C"; cues tape; writes 20-second leader 

PRINT #1;70;CHR$(155);700;CHR$(155);"£7"C." Writes 10 and 100 (numeric 

values) and string value to file in ATASCI1; outputs auto- 
matic EOL; uses CHR$(I55) to signal mid-line EOL 
(prevents concatenation of values); uses semicolons (not 
commas) to compress data 

PUT #1,3 Writes a single numeric value 9: range 0-255 (values can be 

interpreted as ATASCI1 codes); does not output EOL 

CLOSE #7 Outputs data in partially full buffer to #1, then closes ttl 

To Access the File on Tape (Read Values to Variables): 

OPEN #7,4,0, "C:" Opens channel ttl for input (4) to memory (always 0) from 

cassette ("C;"); cues tape; reads 20-second leader 
INPUT #1, A,B$ Reads values written by PR1NT#1 statement above 
GET #1,D Reads numeric value written by PUT #I statement above 

CLOSE ttl Closes channel # 1 

Disk Data Files 

To Create or Add to the Disk File: 

OPEN m.8.0,"D:FlLENAME.EXV Opens channel ttl for output (8) to file (always 
0) on Dl (default); deletes FILENAME.EXT if it exists 

OPEN #7,S,0,"D:FILENAME.EXT" Opens channel #1 to existing FILENAME.EXT 
for appending data 
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PRINT #7;70;CHR$(155);rOO;CHR$(155);"E7~C." Writes 10 and 100 (numeric 

values) and string value to file in ATASCII; outputs auto- 
matic EOL; uses CHRS(155) to signal midline EOL char- 
acters (prevents concatenation of values); uses semicolons 
(not commas) to compress data 

PUT #1,9 Writes a single numeric value 9: range 0-255 (values can be 

interpreted as ATASCII codes); does not output EOL 

CLOSE #7 Forces output of data in partially full buffer to #/, then 

closes til 

To Access the File (Read Values to Variables): 

OPEN #7,4, 0, ■■D:FILENAME.EXV Opens til for input (4) 

INPUT til.A,B,C$ Reads values written by PRINT tf I statement above 

GET til ,D Reads numeric value written by PUT HI statement above 

10OPEN C 1,12,0."D:FILE" ;Opens channel #1 for update (1 2) 

20 GET #1,3 ;Reads first character in FILE 

30 PRINT #1; "ATARI" Replaces characters 2-6 in FILE 

Random Access to Disk File (DOS 2.0S Only) 

NOTE til ,S,C Determines current location of pointer in OPENed file on 

channel til; assigns sector number (1-719) to numeric 
variable S. character number within sector (0-125) to C) 

POINT ti1,S,C Moves pointer to sector 5 character C; S and C must be 

variables 
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Error Messages 



2 


Out of Memory 


137 


3 


Bad Value 


138 


4 


Too Many Variables 


139 


5 


String Length Exceeded 




6 


DATA List Exhausted 


140 


7 


Number Greater Than 32767 


141 


8 


INPUT Statement Type Mismatch 


142 


9 


Array or String Dimension Error 


143 


Id 


Expression Too Complex 


144 


1 1 


Numeric Overflow/Underflow 


145 


12 


Line Not Found 




13 


NEXT Without FOR 


146 


14 


Line Too Long 


147 


15 


GOSUB or FOR Line Deleted 




16 


RETURN Without GOSUB 


150 


17 


Undecipherable Statement 


151 




Encountered 


152 


18 


Invalid String Character 


153 


19 


Program Too Large 


154 


20 


Bad Channel Number 


160 


21 


Not LOAD Format 


161 


128 


Break Abort 


162 


129 


Channel Already Open 


id.; 


130 


Unknown Device 


164 


131 


Output Only 


165 


132 


XIO Syntax Error 


166 


133 


Channel Not Open 


167 


134 


Unknown Channel Number 


168 


135 


Input Only 


169 


136 


End of File 


170 
171 



Record Truncated 

Device Does Not Respond 

Device Malfunctions or Refuses 

Command 

Framing Error on Serial Bus 

Cursor Out of Range 

Data Frame Overrun 

Data Frame Checksum 

Disk Error 

Read-After-Write Compare Error. 

or Bad Screen Mode 

Function Not Implemented 

Insufficient RAM for 

Graphics Mode 

Serial Port Open 

Concurrent Mode Error 

Concurrent Mode Buffer Error 

Concurrent Mode Active 

Concurrent Mode Inactive 

Drive Number Unknown 

Too Many Files Open 

Disk Full 

Unrecoverable System Error 

File Number Mismatch 

Bad File Name 

POINT Data Length Error 

File Locked 

Unknown XIO Command 

Directory Full 

File Not Found 

POINT Invalid 



Error Handling 



PEEK(195) 
PEEK087)' 



256 



Retrieves error code 
PEEK(186) Returns line number with error 
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TRAP 20000 



TRAP 40000 



Disables auto error handling; when executed before error it 
sets flag causing branch to error handling subroutine at line 
20000 when error occurs; the error clears flag 

Turns off current TRAP 





Musical Notes for Pitch Values 




(Values of pitchexpr in SOUND statement) 


Value 


Note 


Value 


Note 


29 


C 


91 


F 


31 


B 


96 


E 


33 


A" B* 


102 


D # /E ,> 


35 


A 


108 


D 


37 


G* A 6 


114 


C#/d 4 


40 


G 


121 


C 


42 


F* C 


128 


B 


45 


F 


136 


A # / B " 


47 


E 


144 


A 


50 


D*/E» 


153 


G # /A" 


53 


D 


162 


G 


57 


C S/|)6 


173 


F # 'B" 


60 


c 


182 


F 


64 


B 


193 


E 


68 


A# B" 


204 


Dtt/E" 


72 


A 


217 


D 


76 


G« A" 


230 


C" D* 


81 


G 


243 


C 


85 


pft Qi 







Machine Language 

Memory locations addressed by number, 0-65535. Each location has a numeric 
value of 0-255. Two art locations (such as SAVMSC, 88-89) are read with: 

SAVMSC=PEEK(88)+256*PEEK(90) 
PEEK(S2) Returns decimal value stored at memory location 82 

POKE 82,226 Writes decimal 226 to memory location 82 
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Useful PEEK and POKE Locations 
Memory Configuration: 

14.15 Highest memory used by BASIC program 

88,89 Screen Memory Address (SAVMSC) 

106 Top of RAM Address (Mosi Significant Byte) (RAMTOP) 

741,742 Free Memory High Address (MEMTOP) 

743.744 Free Memory Low Address 

Display Screen: 

77 Attract Mode (ATRACT) 

82 Left Margin of Text Area (LMARGN) 

83 Right Margin of Text Area (RMARGN) 

84 Current Cursor Row (ROWCRS) 
85.86 Current Cursor column (COI.CRS) 
87 Display Mode (DINDEX) 

90 Starting Graphics Cursor Row (OLDROW) 

91,92 Starting Graphics Cursor Column (OLDCOl.) 

93 Cursor Character Save/Restore (OLDCHR) 

94.95 Cursor Memory Add ress ( O L DA DR ) 

96 Ending Graphics Cursor Row (NEWROW) 

297,98 Ending Graphics Cursor Column (NEWCOL) 

201 Display Screen Tab Interval (PTABW) 

656 Text Cursor Row Position (TXTROW) 

657,658 Text Cursor Column Position (TXTCOL) 

675-680 Display Screen Tab Stop Map (TABMAP) 

752 Cursor Inhibit (CRS1NH) 

755 Character and Cursor Control (CH ACT) 

756 Character Address Base (CHBAS) 

765 Fill Data (F1LDAT) 

766 Display Control Characters (DSPFLG) 

659 Splil-Screen Text Windown Screen Mode (TINDEX) 

660,661 Split-Screen Memory Address (TXTMSC) 

665-667 Split-Screen Cursor Data 

763 Last ATASCI Character or Plot Point (ATACHR) 

54273 Character Control Register (CH ACTL), same as CH ACT 
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Display Lists: 



512.513 Display List Interrupt Vector ( VDSL! ST) 

559 DMA Control Register (SDMCTL) 

560.561 Display List Address (SDLST) 

54286 Non-maskable Interrupt Enable (NMIEN) 

Player-Missile Graphics: 

623 Player Playfield Priorities (CiPRIOR) 

704-707 Player-Missile Color Registers (COLPM0-COLPM3) 

53248-53251 Player Horizontal Position Registers ( HPOSP0-HPOSP3) 

53256-53259 Player Width Registers (SIZEP0-SIZEP3) 

53260 Missile Width Register (S1ZEM) 

53277 Graphics Control Register (GRACTL) 

54279,54280 Player-Missile Base Register (PMBASE) 

Cassette Buffer: 

61 Cassette Buffer Pointer (DPTR) 

63 Cassette End-of-File Flag (FEOF) 

64 Beep Count (FREQ) 

649 Cassette Read Write Mode Flag(WMODE) 

650 Cassette Buffer Size (BI.IM) 
1021-151 Cassette Buffer (CASEBUF) 

Keyboard: 

17 BREAK Key Flag (BRKKEY) 

694 Inverse Video Keystrokes (INVFLG) 

702 Shift Control Lock Flag(SHFLOK) 

764 Keyboard Character (CH) 

767 Stan Stop Display Screen (SSFLAG) 

53279 CONSOLE Switch Port (CONSOL) 

Sound Control: 

65 Input/Output Noise Control (SOUNDR) 



Printer: 



29 Printer Buffer Pointer ( PBPN T) 

30 Printer Buffer Size ( PBU FSZ) 
960-999 Printer Buffer (PRNBUF) 
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Free Memory Area: 

1536-l(i63 Conditionally Available 

1664-1791 Unconditionally Available 

BASIC Program Control: 

186.187 Slop Line Number (STOPLN) 

195 Error Number (HRRSAV) 

212.213 HSR Function Value (FRO) 

251 Radians or Degrees (RADFLG or DEGFLG) 

564 Light Pen Horizontal Position (LPENI1) 

565 Light Pen Vertical Position (l.PENV) 

Other: 

18-20 Real Time Clock (RTC) 

832-960 10CI3's 0-7 (IOCB0-IOCB7) 

Interrupt Control: 

53744 IRQ Interrupt Status Enable 1 1 RQST I RQEN) 

Branching to Machine Language Subroutines from BASIC: 

PRINT USR(7536) Branches to machine program starting at 1536 

(decimal) 
PRINT USR(ADR(S6/8/i$)) Branches to machine language program stored in 

SUBRS; uses ADR to specify location of program 
PRINT USR(7536,3,,/00) Branches, passes values of parameters 2-4 

1. Parameters converted to 2-byte hexadecimal integers (0-65535) 

2. Location of USR function pushed onto bottom of hardware stack 

3. Parameters 2-4 PLACED on stack, last (100) first; low bytes before high 

4. 1 -byte count of 2-byte values (not including address) pushed on top 

5. Returns to BASIC only if program at 1536 removes all entries 
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Memory Usage 





Operating 




Memnn 
Usage 




"N. 


ROM 












S\MCIJ1 X 














1 "< - 


_^^~ 








53248 


U \sl( ROM 










RAM 1 w:ii b\ DO* 
ami hie System 
Managci 








V \ 






It \M ! wrd \ 
RcmUl'iii \ 


U, s 


Operating 
Svsiem RAM 




/ BASIC Zt-ro 
/ Page RAM 


Cartridge 




In BASIC 


/ 









ATARI 400/800 Computer Memory Map 
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64 K 



56 K 



40 K 



32 K 



24 K 



16k 



KK 



OK 



l.cfl Cartridge Only 



Left and Right Cartridge 
(ATARI 800 computer) 



Right Cartridge Only 
(ATARI 800 computer) 



Operating 
System ROM 



Floating point routines 



I/O chips 



Unused 



////////// 

/////////// 

/////////// 



W, 



Operating 
System ROM 



Floating point routines 



I/O chips 



Unused 




/////////// 
////// / / / / / 
/////////// 







Operating 
System ROM 



Floating point routines 



I/O chips 



Unused 



/////////// 
/////////// 
/////////// 



Memory Usage 
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No Cartridges 



Operating 
System ROM 



Floating point routines 



I O chips 



Unused 




/////////// 
/////////// 
/////////// 



Legend: 
I I ROM 
I | RAM 
EX2 Free RAM 
| | Not available 

Left cartridge 

Right cartridge 
II 1 1 1 ] I Display (exact size depends on graphics mode) 

V7~k dos 

Fxoil BASIC RAM (if BASIC cartridge present) 

Operating system RAM 



Memory Usage 
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Memory Locations 
Without BASIC Resident 



Operating system ROM 



Floating point routines 



I O chips 



Unused 



1 eft cartridge RO 



Right cartridge 

present 

computer 



RAM (8K to 



DOS. when present 



M. when present 



ROM. when 
(ATARI 800 
only) 



40K additional) 



Operating system RAM 



65536 

57144 
55246 
53248 
44152 

40960 

32768 

24576 

10879 
1792 



Memory Locations with 
Standard ATARI BASIC Resident 



Operating system ROM 



Moating point routines 



I O chips 



Unused 



BASIC ROM 



Right cartridge 

present 

computer 



BASIC program. 

run-time 

IKK in HK 



DOS. when present 



ROM. when 
(ATARI 800 

onlv) 



butlers, tables 

slack 
additional) 



XK BASIC and Operating 
RAM system 



i65536 

■ 57344 

■ 55296 
53248 

-49152 

■ 40960 

3276S 

24576 

10879 
1792 
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Operating System ROM (Memory Locations 55296-65535) 


Location 


Usage 


55296-57393 


Floating point routines 


57344-58367 


Character set 


58368-58533 


Vectors 


58534-59092 


CIO 


59093-59715 


Interrupt handler 


59716-60905 


SIO 


60906-61047 


Disk handler 


61048-61248 


Printer handler 


61249-61666 


Cassette handler 


61667-62435 


Monitor 


62436-65535 


Display and keyboard handler 



Operating System Vectors (Memory Locations 58368-58533) 


Location 


Type of Memory 


Usage 


58368-58383 


ROM 


Editor 


58384-58399 


ROM 


Screen 


58400-58415 


ROM 


Keyboard 


58416-58431 


ROM 


Printer 


58432-58447 


ROM 


Cassette 


58448-58495 


ROM 


Jump vectors 


58496-58533 


ROM 


Initial RAM vectors 



I/O Chips (Memory Locations 532-55295) 


Location 


Type of Memory 


Usage 


5324S-53503 


I O 


CI IA or GTIA 


53504-53759 


1 () 


Unused 


54760-54015 


1 () 


POKEY 


54016-54271 


1 () 


PI A 


54272-54783 


1 () 


AN 1 IC 


54784-55295 


1 O 


Unused 



47 



Operating System RAM (Memory Locations 512-1151) 


Location 


Usage 


512-553 


Interrupt vectors 


554-623 


Miscellaneous 


624-647 


Game controllers 


648-655 


Miscellaneous 


656-703 


Screen RAM (depends on graphics mode) 


704-71 1 


Colors 


712-735 


Spare 


736-767 


Miscellaneous 


768-779 


DCB 


7X0-793 


Miscellaneous 


794-831 


Handler address tables 


832-847 


1 O Channel (IOCB0) 


848-863 


1 O Channel 1 (IOCBI) 


864-879 


1 O Channel 2 (IOCB2) 


880-895 


1 O Channel 3 (10CB3) 


896-9 1 1 


I/O Channel 4 (IOCB4) 


912-927 


1 O Channel 5 (IOCB5) 


928-943 


1 O Channel 6 (IOCB6) 


944-959 


1 O Channel 7 (IOCB7) 


960-999 


Printer buffer 


1000-1020 


Spare 


1021-1 151 


Cassette buffer 



RAM Used by Operating System, Resident Cartridge, 
or Free RAM (Memory Locations 0-2047) 


Location 


Usage 


0-127 
128-255 
256-5 1 1 


Operating system zero page RAM 

User zero page RAM 

Stack 


512-1151 
1152-1791 
1792-2047 


Operating System RAM 
User RAM" 
User Boot Area 
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BASIC* ROM 


(Memor 


Locations 40960-49151 


Location 


I'sage 


Location 


I'sage 


40960-41036 


Cold start 




43744-44094 


Execute expression 


410.17-41055 


Warm start 




44095-44163 


Operator precedence 


41056-42081 


Syntax 




44164-45001 


Execute operator 


42082-42158 


Search 




45002-45320 


Execute function 


42159-42508 


Statement name u 


blc 


45321-47127 


Execute statement 


42509-43134 


Syntax tables 




47128-473X1 


CON 1 subroutines 


43135-43358 


Memory manager 




47382-47542 


Errors 


43359^3519 


Execute COM 




47543-47732 


Graphics 


43520-4363 1 


Statement tank- 




47733-48548 


1 O routines 


43632-43743 


Operator table 




48549-49151 


Floating point 


* Applies to star 


dard ATARI BASIC 


only. 







RAM Used by BASIC* (Memory Locations 0-255F) 


I sage 


Location 


0-127 


Operating svstem zero patze RAM 




128-255 


BASIC zero page RAM 




256-5 1 1 


Stack 




512-1151 


Operating system RAM 




1 152-1405 


Svntax stack 




1406-1535 


Input line buffer 




1 536- 1 79 1 


Free RAM 




1792-End of 


BASIC program: 




Iree RAM 


Syntax buffer or argument stack** 

Name table** 

Value table** 

I okeni/ed program** 

Array-strings area** 

Run-time slack** 




* Applies to standard ATARI BASIC only. 




** The actual memory locations depend on program and variable 


usage. 
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BASIC Zero Page RAM (Memory Locations 128-255) 


Location 


Lsage 


128-145 
146-202 
203-209 
210-255 


Program pointers 

Misc. BASIC RAM 

Unused 

Floating point work area 



RAM Used by DOS Version 1.0 and 
File Management System (FMS) 


Location 


Usage 


1 792-4863 
4864-9855 
9856-10879 


File management system RAM 
Disk operating system (DOS) RAM 
Disk I/O buffers 



RAM Used by DOS Version 2.0S and 
File Management System (FMS) 


Location 


Usage 


1792-4863 
4864-9855 
9856-10879 
10880-LOMEM 


File management system RAM 
Disk operating system (DOS) RAM 
Drive 1-4 buffers and sector buffers 1-2 
Disk operating system (DOS) 

Utility programs (Sector buffers 3-7) 
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Codes, Characters, and Keystrokes 



Codes, Character 


i, and Keystrokes 






75 

X ° 

Q O 


U 2 


ASCII 
Character 
(If Any) 


Keystrokes to 

Produce 

Character 


"5 

1 a 
a u 


SB 3 


ASCII 
Character 
(If Any) 


Keystrokes to 

Produce 

Character 





H 


NULL 


CTRL-, 


13 


n 


CR 


CTRI.-M 


1 


[B 


SOH 


CTRL-A 


14 


y 


SO 


CTRL-N 


2 


□ 


STX 


CTRL-B 


15 





SI 


CTRL-O 


3 


H 


ETX 


CTRL-C 


16 


a 


DLE 


CTRL-P 


4 


ffi 


EOT 


CTRL-D 


17 


a 


DCI 


CTR1.-Q 


5 


a 


ENQ 


CTRL-E 


18 


H 


DC2 


CTRL-R 


6 


[71 


ACK 


CTRL-F 


19 


LB 


DC3 


CTRI -S 


7 




\ 




BEL 


CTRL-Q 


20 


W 


DC4 


CTRL-T 


8 


\J\ 


BS 


CTRL-H 


21 


H 


NAK 


CTRL-U 


9 


a 


HT 


CTRL-I 


22 


E 


SYN 


CTRL-V 


10 


E 


LE 


CTRL-J 


23 


H 


ETB 


CTRL-W 


11 


a 


VT 


CTRL-K 


24 


ffl 


CAN 


CTRL-X 


12 


E 


FF 


CTRI.-I. 


25 


E 


EM 


CTRL-Y 
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(tides. Characters, and Keystrokes (Continued) 



u -a 

a u 



^ z 

S/3 31 



« X _ 

< u c 



,j o 
Q U 



5 fi a 

< W — 



w "n i- 

>. o * 



26 

27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 



s 

t] 2 
S' 

n 
m 
m 

□ 



SUB 

ESC 

FS 

GS 

RS 

US 

Sp;ice 



ESC\CTRI.-+ 



SPACE BAR 
SHIFT-I 
SHIFT-2 
SHIFT-3 



SH1FT-5 



SH1FT.6 
SH1FT-7 



40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 



m 

m 

a 
s 
s 

B 
S 

m 
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( odes, ( haractcrs, and Keystrokes (Continued) 



o -a 
v © 
Q U 









:/: .c w 

< O - 



a o 



< W ~ 



O (j o 

£ 3 « 



54 
55 
56 
57 
58 
59 
60 
<il 

62 
63 
64 
65 
66 
67 



6 



o 

o 





JiL 

A 

I- 1 



@ 


S H 1 1 I 


-8 


A 


A 




B 


B 




C 


C 





68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 



D 



G 



H 

I 



E 

N 




Q 



i) 

E 
F 
G 
II 
I 

J 
K 
I. 
M 
N 
O 
P 

Q 



I) 

E 

F 

G 

II 

I 

J 

K 

L 

M 

N 

O 

P 

Q 
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(odes. ( haracters. and Keystrokes (Continued) 



a u 



I- £ 



!/) JS ta 

« o - 






21 



— « c 

y a -* 

2 * s 

< u c 



u o 

i: a a 

a: o. u 



82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 



PL 

m 
m 

~v7~ 



Y 






R 

S 
T 
U 
V 

w 

X 
Y 
Z 

[ 

\ 



R 

S 
T 
U 
V 

w 

X 

Y 

Z 
sun- 1- ; 
SHIFT- , 
SHIFT- + 
SHIFT- * 
SHIM-- 



96 

97 

98 

99 
100 

101 

1(12 
103 
104 
105 
106 
107 
108 
109 



H 



& 






M 



CTRL-. 

(I.OWR) A 

(I.OWR) B 

(LOWR) C 
(LOWR) D 

(LOWR) E 

(LOWR) F 

(LOWR) G 

(LOWR) H 

(LOWR) 1 

(LOWR) J 

(L.OWR)K 

(LOWR) L 

(LOWR) M 
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( odes, ( liaracterv and Keystrokes (Continued) 


15 

.1 * 

u -a 
C ;_ 


5 s 

r— £ 


Character 

(If Any) 


Keystrokes to 

Produce 

Character 






ASCII 

Character 
(If Any) 


Keystrokes to 

Produce 

Character 


110 


EB 


n 


(LOWR) N 


124 


m 


I 


shir- = 


III 


R^ 





(1 OWR) 


125 


m 


I 


ESCNCTRI •< 

or 
ESC\SHIFT-< 


112 




p 




P 


II OWR) p 


126 




1 




~ 


ESC\BACK S 


113 


1*1 


q 


II OWR) Q 


127 


111' 


DEL 


ESCVI'AB 


114 


E 


r 


ll OWR) R 


128 


□ 




(A)CIRI •, 


115 


E 


s 


(LOWR) S 


129 


c 




(A)CIRI-A 


116 


E 


t 


ll OWR) T 


130 


n 




(A)CTRl.-B 


117 


td 


u 


ll OWR) V 


131 


a 




(A)CIRI-C 


118 


H 


V 


ll OWR| V 


132 


Q 




(A) CTRL-D 


119 




w 




w 


ll OWR) W 


133 


a 




(A) CTRL-E 


120 




t '. 




X 


ll OWR) \ 


134 


Q 




(A) CTRI -I- 


121 




y 




y 


ll OWR] V 


135 


□ 




(A) CTRL-0 


122 


1*1 


7 


(1 OWR) Z 


136 


B 




(A)CTRI-II 


123 


E 


1 


CTRL-: 


137 


B 




(A) CTRI -I 
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Codes, Characters, and Keystrokes (Continued) 


1 * 

X ° 

a u 


5 1 

VI a 

H .e 
< U 


ASCII 
Character 
(If Any) 


Keystrokes to 

Produce 

Character 


3 
1 . 

Q O 


5 1 

m 3 
< U 


ASCII 
Character 
(If Any) 


Keystrokes to 

Produce 

Character 


138 


a 




(A) CIRI-J 


152 


C3 




(a) n hi x 


139 


B 




(A) CTRL-K 


153 


a 




(A) CTRI.-Y 


140 


a 




(A) CTRL-L 


154 


D 




(A) CTRI Z 


14! 


H 




(A) CTRL-M 


155 


EOL' 




(A) 
RETURN 


142 


B 




(A) CTRL-N 


156 


□ 




ESCXSHIF T- 
BACK S 


143 


a 




(A) CI RL-O 


157 


□ 




ESC\SHIFT-> 


144 


□ 




(A) CTRL-P 


158 


□ 




ESCACTRL- 
TAI1 


145 


B 




(A) CTRL-Q 


159 


□ 




ESCXSIHFT- 
TAB 


146 


D 




(A) C'TRI.-R 


160 


■ 




(A) 

SPACE BAR 


147 


□ 




(A) CTRI.-S 


161 


11 




(A) Sllll-I-I 


148 


D 




(A) CTRI 1 


162 


B 




(A) Kim 1-2 


149 


H 




(A) CTRL-l) 


163 







(A) SHIFT-3 


150 


n 




(A) CTRL-V 


164 


El 




(A) Sllll'l-J 


151 


□ 




(A) CTRL-W 


165 


YA 




(A) SH1FT-S 
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Codes, Characters, and Keystrokes (Continued) 


J * 

w -a 
£ ° 


5 1 


ASCII 

Character 
(If Any) 


Keystrokes to 

Produce 

Character 


93 

.1 « 


< ~ 
1- .= 


ASCII 
Character 

(If Any) 


Keystrokes to 

Produce 

Character 


166 


O 




(A) SH1I-I-6 


180 


□ 




(A) 4 


167 


■ 




(A) SHIR-7 


181 


B 




(A) 5 


168 


D 




(A) SHIFT-9 


182 


B 




(A) 6 


169 


D 




(A) SHU 1-0 


183 


B 




(A) 7 


170 


□ 




(A) * 


184 


B 




(A) 8 


171 


□ 




(A) + 


185 


B 




(A) 9 


172 


B 




(A) . 


186 


B 




(A) Sllll- I-; 


173 


D 




(A) - 


187 


B 




(A) . 


174 


B 




(Al . 


188 


B 




(A) < 


175 


B 




(A) 


189 


g 




(A) = 


176 


B 




(A) 


190 


B 




(A) > 


177 


fl 




(A) 1 


191 


B 




(A) SHIFT-/ 


178 


B 




(A) 2 


192 


B 




(A) SHIFT-8 


179 


B 




(A) 3 


193 







(A) A 
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Codes, Characters, and Keystrokes (Continued) 


"3 

.1 . 

a l> 


F s 


ASCII 

Character 
(If Any) 


Keystrokes to 

Produce 

Character 


91 

1 - 

Hi - 


< u 


ASCII 
Character 
(If Any) 


Keystrokes to 

Produce 

Character 


194 







(A) B 


208 


D 




(A) P 


195 


H 




(A) C 


209 


a 




(A)Q 


196 


a 




(A) D 


210 







(A) R 


197 


H 




(A)C 


211 


B 




(A)S 


198 


H 




(A) F 


212 


o 




(A)T 


199 


B 




(A) Ci 


213 


m 




(A.) U 


200 


m 




(A) H 


214 


EJ 




(A) V 


201 


El 




(A) 1 


215 


G3 




(A)W 


202 


ID 




(A) J 


216 


□ 




U)X 


203 


IB 




(A) K 


217 


□ 




(A) Y 


204 


H 




(A) |. 


218 


H 




(A) Z 


205 


na 




(A)M 


219 


H 




(A) SHIM-. 


206 


m 




(A)N 


220 


Q 




(A) SHIFT-* 


207 


m 




(A) O 


221 


H 




(A) SHIFT-. 
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(Odes, ( haracters, and Keystrokes (( ontinued) 


"3 

.1 „ 

w -a 

it 5 

a u 


si 


ASCII 
Character 
(If Any) 


Keystrokes to 

Produce 

Character 


Z T3 
a* 


mm & 


ASCII 
Character 
(If Anv) 


Keystrokes to 

Produce 

Character 


222 


D 




(A) st! 11 l-» 


236 


D 




(A) il OWR) 

1 


223 


H 




(A) sllll I-- 


237 


13 




(A) (I.OWR) 

M 


224 


Q 




(A) CI HI -. 


23S 


ra 




(A) (LOWR) 


225 


m 




(A) (1 OWR) 
A 


23') 


ra 




(A) (LOWR) 
O 


226 


® 




(A) il OWR] 
It 


240 


KB 




(A) (LOWR) 


227 


m 




(A) (LOWR) 
C 


241 


El 




(A) (LOWR) 


(A) (I.OWR) 


228 


m 




(A) il OWR] 

1) 


242 


D 




229 


m 




(A) il OWR) 

1 


243 


S 




(A) (I.OWR) 


230 


Q 




(A) il OWR) 
1 


244 


Q 




(A) (I.OWR) 


231 


m 




(A) (LOWR) 

Ci 


245 


D 




(A) (LOWR) 


232 


ra 




(A) (LOWR) 

II 


246 


H 




(A) (I.OWR) 


233 


H 




(A) (LOWR) 

1 


247 


IB 




(A) (LOWR) 


234 


B 




(A) (LOWR) 

j 


248 


m 




(A) (LOWR) 
X 

(A) (I.OWR) 
Y 


235 


19 




(A) (LOWR) 
K 


249 


m 
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Codes, Characters, and Keystrokes (Continued) 



u -O 

Q U 



H x: 
< O 



<l u c 



JO J 



« 

Q U 



o 


ai 


:r 


09 


< 




H 


,.1= 


< 


u 



w j: «4- 



mi -O u 



250 

251 
252 



□ 



ESCNCTR1.-2 

(A) 

ESC\ CTRL- 
BACK S 

(A) ESC\ 
CTRL-> 



253 
254 
255 



(A) 

(LOWR) Z 
(A) CI RL- ; 

(A)sHII-T- 



Notes: 

'The character L5k- represents a control character. In most cases, this control character does nothing; 
CHRS(27) is generally a nondisplaying character. However, if the next character displayed is a 
control characterlATASCll codes 27. 28. .29. 30. 3 1. 125. 126. 127. 156. 157. 158, 159. 253. 254. or 
255). the control process does not take place. Instead, the representative character itself appears. 

2 The character "^ represents the control character which moves the cursor up one row. It' the 
character displayed just before this was AT ASCI I code 27. the character + displays; the cursor does 
not move. 

3 The character A represents the control character which moves the cursor down one row. II the 
character displayed just before this was AT ASCI I code 27. the character L+i displays; the cursor does 
not move. 

'The character l*~ represents the control character which moves the cursor one column left. If the 
character displayed just before this was ATASCTI code 27. the character EJ displays; the cursor does 
not move. 

5 The character A represents the control character which moves the cursor one column right. If the 
character displayed just before this was ATASCTI code 27. thecharactet 1^1 displays; the cursor does 
not move. 

"The character & represents the control character which clears the screen and moves the cursor_to 
the home position. If the character displayed just before this was AT ASCI I code 27. the character JL 
displays; the screen is not cleared. 
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Codes, Characters, and Keystrokes (Continued) 



Notes (continued): 

'The character ji represents the control character which moves the cursor one column left and 
replaces the character [here with a hlunk space. II the character displayed just before this was 
ATASC1I code 27. the character _^ displays: the cursor does not move. 

* I he character X. represents the control character which advances the cursor to the next tab slop. If 
the character displayed just before this was ATASCII code 27. the character \ , displays; the cursor 
does not move. 

The ATASCII end-of-line character. 

I he character u represents the control character which deletes the line on which the cursor is 
located. If the character displayed just before this was ATASCII code 27, the character U displays; 
the deletion does not occur. 

The character u represents the control character which inserts a line above the one on which the 
cursor is located. II the character displayed just before this was ATASCII code 27, the character £3 

displays; the insertion does not occur. 

1 he character D represents the control character which clears the tab slop (if any) at the current 
cursor position. If the character displayed just before this was ATASCII code 27. the character Q 
displays; no tab slop is affected. 

The character E3 represents the control character which sets a tab stop at the current cursor 
position. If the character displayed fust before this was ATASCII code 27. the character El displays; 
no tab stop is set. 

''The character d represents the control character which beeps the built-in speaker; nothing is 
displayed. II the character displayed just before this was ATASCII code 27. the character U\ 
displays: ihe speaker remains silent. 

''The character LI represents the control character which deletes the character to the right of the 
cursor, shifting the remainder of the logical line one space to the left. If the character displayed just 
before this was ATASCII code 27. the character D displays-, no deletion occurs. 

The character U represents the control character which inserts a blank space to the right of the 
cursor, shilling t he remainder of i he logical line one space to the right. If the character displayed just 
before this was ATASCII code 27. the character Q displays: no insertion occurs. 
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ATARI BASIC Keywords and 
Abbreviations 



Keyword 


Abbrev. 


Keyword 


Abbrev. 


Keyword 


Abbrev. 


ABS 




GOTO 


G. 


PUT 


PU. 


ADR 




GRAPHICS 


GR. 


RAD 




AND 




IF 




READ 


REA. 


ASC 




INPUT 


1. 


REM 


R. or 


ATN 




INT 




RESTORE 


RES. 


BYE 


B. 


LEN 




RETURN 


RET. 


CLOAD 


CLOA. 


LET 


LE. 


RND 




CHRS 




LIST 


L. 


RUN 


RU. 


CLOG 




LOAD 


LO. 


SAVE 


S. 


CLOSE 


CL. 


LOCATE 


LOC. 


SETCOLOR 


SE. 


CLR 




LOG 




SGN 




COLOR 


C. 


LPRINT 


LP. 


SIN 




COM 




NEW 




SOUND 


SO. 


CONT 


CON. 


NEXT 


N. 


SQR 




COS 




NOT 




STATUS 


ST. 


CSAVE 


CS. 


NOTE 


NO. 


STEP 




DATA 


D. 


ON 




STICK 




DEG 


DE. 


OPEN 


O. 


STRIG 




DIM 


Dl. 


OR 




STOP 


STO. 


DOS 


DO. 


PADDLE 




STR$ 




DRAWTO 


DR. 


PEEK 




THEN 




END 




PLOT 


PL. 


TO 




ENTER 


E. 


POINT 


P. 


TRAP 


T. 


EXP 




POKE 


POK. 


USR 




FOR 


F. 


POP 




VAL 




FRE 




POSITION 


POS. 


XIO 


X. 


GET 


GE. 


PRINT 


PR. or ? 






GOSUB 


GOS. 


PTRIG 
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Index 



« A 



ADR. 16 
AND. 14. 18 
ASC, 16 

B 

BASIC Branch statements, 

16-17 
BASIC Nesting. 18 
Boolean Truth Table. 14 
BYE. 18 



Channel 1/0,33 
CHRS. 15, 16 
CLOAD. 10 
CLOSE, 22. 31,36. 37 
CLR, 12 

COLOR, 20. 22. 23. 24. 25 
COM, 12 
Concatenation, substrings 

and, 16 
CONT. 10. 18. 19 
CSAVE. 10. 11 

D 

DATA. 12. 18 
DIM. 12 
DOS, 6, 27 
DRAWTO, 25 

E 

END. 9. 18, 19 
ENTER, 10. II. 33 
= . 18 
Escape sequences, 15 



FOR. 17 
FRE. 10 



GET. 19. 22. 33, 36. 37 
GOSUB, 17. 18 
GOTO. 16 
GRAPHICS. 22 
Graphics Tables. 20- 21. 
23 24 

I 

IF, 18. 19 

INPUT, 19.22. 33.36.37 

K 

Key Functions and Combina- 
tions. 5 
Keys. 4-5 

Back. 5. 15 

Break. 4. 10, II, 19 

Caps/ Lower. 4. 5 

CTRL. 4. 5. 15,30 

ESC, 4. 15. 30 

Shift. 4— 5, 15 

System Reset. 4. 9. 18. 19. 
27 

TAB. 5. 15 



LEN. 16 

LET. 18 

LIST. 9. 10. II. 29. 33 

LOAD. 5 -6. 10 



LOCATE, 22, 25 
LPRINT. 29 

M 

Math Functions and State- 
ments. 13 

ABS. 12 

ATN. 12 

CLOG, 12 

COS. 12 

DEC. 12 

EXP. 12. 18 

INT, 12 

LOG, 12 

RAD, 12 

RND, 12 

SGN. 12 

SIN, 12 

SQR. 12 
Memory configuration, 40 
Memory locations, 40- 42 

BASIC program control, 42 

Cassette buffer, 41 

Display lists, 41 

Display screen. 40 

Free memory area, 41 

Interrupt control. 42 

Keyboard, 41 

Other, 42 

Player-Missile graphics, 41 

Printer, 41 

Sound control, 41 
Modes I 2, Graphics. 

22 24 
Modes 3 8. Graphics, 25 
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N 

NEW, 9. 10. 18 

NEXT. 17 

NOT. 14 

NOTE. 37 

Numeric constants, 13 

Numeric Operators, 14 

o 

ON. 16 

OPEN, 31.32. 36. 37 
OPEN Parameters, 31—32 
OR. 14 

P 

PADDLE. 28 
PEEK. .38. 39.40 
Player-Missile graphics, 

" 26 27 
PLOT, 25 
POINT. 37 
POKE. 39. 40 
POP, 17 

POSITION, 22. 25 
PRINT. 10, 17. 18, 22. 29. 33. 

36. 37 
Printer Characters, 29 -30 
PTRIG. 28 
PUT. 22, 29, 33. 36. 37 



RAM and ROM table 

43-50 
READ, 12. 18 
REM. 17. 18 
RESTORE. 
RETURN. 17 
RUN, 9. 10, II 



18 



SAVE, 5- 6, 10 
SETCOLOR. 21. 25 
SOUND. 27.39 

STATUS, 62 
STEP. 17 
STICK, 28 
STOP, 9, 18, 19 
STRS. 16 
STR1G.28 
Siring functions, 16 



I'll EN. 18 

TO, 17 

Transferring programs, 10 — II 

TRAP. 18, 39 



u 

USR, 16. 18.42 
Utilities menu, 6 9 

Binary load, 9 

Binary save, 8 

Create mem. saw 9 

Copy file, 7 

Delete file, 7 

Disk directory, 6 

Duplicate disk, 8 

Duplicate file, 9 

Format disk, 8 

Lock file. 8 

Rename file, 8 

Run at Address, 9 

Run Cartridge. 7 

Unlock file. 8 

Write DOS files. 8 

V 

VAL. 16 

Variable Name "fable (VNT). 

10. II 
Variable names, 12 

X 

XIO. 25, 33 

XIO Commands and Parame- 
ters. 34 35 
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ATARI" 400/800 M DiskGuide 

ATARI " 400/800 ,M users will find quick-reference 
tips on DOS, ATARI" BASIC, numeric functions, 
machine functions, and more in this DiskGuide.™ 
Tables, charts, and diagrams are also included in this 
easy-to-use, computer-side reference. 

Look for other Osborne/McGraw-Hill titles including: 

• Your ATARI " Computer: A Guide to the ATARI" 
400/800 M Personal Computers 

• ATARI is a registered trademark and 400/800 is a trademark 
of Atari, Inc. 

• DiskGuide is a trademark of Osborne/McGraw-Hill. 




